home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmindomstr.z / pmindomstr
Text File  |  1997-04-03  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMIIIINNNNDDDDOOOOMMMMSSSSTTTTRRRR((((3333))))                                                    PPPPMMMMIIIINNNNDDDDOOOOMMMMSSSSTTTTRRRR((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmIIIInnnnDDDDoooommmmSSSSttttrrrr - convert a performance metric instance domain identifier into
  10.      a string
  11.  
  12. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  14.  
  15.      cccchhhhaaaarrrr ****ppppmmmmIIIInnnnDDDDoooommmmSSSSttttrrrr((((ppppmmmmIIIInnnnDDDDoooommmm iiiinnnnddddoooommmm))))
  16.  
  17.      cccccccc ............ ----llllppppccccpppp
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      For use in error and diagnostic messages, return a 'human readable'
  21.      version of the specified instance domain identifier.
  22.  
  23.      The value for the instance domain _i_n_d_o_m is typically extracted from a
  24.      _p_m_D_e_s_c structure, following a call to ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for a particular
  25.      performance metric.
  26.  
  27.      Internally, an instance domain identifier is encoded as follows;
  28.  
  29.           typedef struct {
  30.               int             pad:2;
  31.               unsigned int    domain:8;        /* the administrative PMD */
  32.               unsigned int    serial:22;       /* unique within PMD */
  33.           } _pmInDom_int;
  34.  
  35.      ppppmmmmIIIInnnnDDDDoooommmmSSSSttttrrrr returns a string with each of the _d_o_m_a_i_n and _s_e_r_i_a_l subfields
  36.      appearing as decimal numbers, separated by periods.
  37.  
  38.      The string value is held in a single static buffer, so the returned value
  39.      is only valid until the next call to ppppmmmmIIIInnnnDDDDoooommmmSSSSttttrrrr.
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmIIIIDDDDSSSSttttrrrr(3) and ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3).
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.